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The Apollo Modem 


INTRODUCTION 


Welcome to the Apollo communications ROM for the BBC 
Microcomputer. We hope that you will enjoy using this piece of 
software, and the associated hardware, and that you will get many 
hours of pleasure from the new and expanding world of home 
communications. 

The Apollo ROM has been designed to be used on two levels. 
Firstly, for the user who simply wants to access commercial database 
systems and bulletin boards, and possibly transfer files between 
friends. Secondly, for the user who wishes to write his/her own 
communications software. This latter group can utilise the powerful 
commands included in the Apollo ROM for such applications as running 
their own bulletin boards, or remote user access (more on these 
later...). 

The Apollo modem itself uses standard RS232 protocols, but it is 
partly software controlled from the Apollo ROM. 
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ROM INSTALLATION 


BBC MICROCOMPUTER MODEL B 

The first stage in fitting the Apollo ROM to your BBC is to 
ensure that you have the appropriate version of the operating system 
fitted to your machine. Type *FXO and check that the OS number 
returned is 1.00 or greater. If the number printed is lower, then you 
will also need a new Operating System ROM fitted to your machine. 

Having ensured that you have the correct operating system, turn 
the BBC micro off, and remove the lid by undoing the four screws 
marked FIX on the case. If you have a ROM board fitted to your 
machine then refer to the instructions supplied with the ROM board 
itself for the finer points of fitting ROMs to the ROM board. 

Next, undo the screws that attach the keyboard to the BBC micro, 
and carefully rotate the keyboard through about 20 degrees clockwise 
to reveal the four sideways ROM sockets. The socket that the Apollo 
ROM is fitted in is not very important, although the higher the 
priority the less chance of a software clash. 

Once a free socket has been found for the Apollo ROM, take the 
ROM from its protective foam or tube, and check that the legs are at 
the correct angle. If they are not, then you should bend them 
appropriately by placing the ROM on its side on a flat surface, and, 
by applying firm and even pressure, bend the legs where they are at 
their thickest (closest to the ROM body) until they match with the 
socket into which the ROM is to be inserted. 

You should now insert the ROM into its socket. Note that the 
small notch at one end MUST face the rear of the machine (All the 
other chips on your BBC will also face in this direction). YOU will 
damage the ROM if it faces the wrong way when the power is turned on. 
Line the pins up with the socket, and apply gentle pressure until the 
ROM fits into its socket. Check that all the legs have fitted 
correctly, and that none are bent out from the socket. 
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CHECKING THE ROM WORKS 


Once the ROM has been inserted into your machine you need to test 
it. Whether you screw the lid and keyboard back to the BBC micro 
before or after testing is entirely up to you, but they both ideally 
want to be fixed back into their old positions before prolonged use. 
When you are ready, connect the BBC micro back to the power, video 
display and any other peripherals that you may have, and turn on the 
power. To check that the Apollo ROM is fitted correctly and working, 
enter the following: 

♦HELP 

If the Apollo ROM is installed correctly, then something like the 
following will be printed on the screen (possibly along with text 
from other ROMs present): 

Apollo ROM 1.03 

If this message, or a similar one, does not appear, then recheck 
the fitting operation, removing the ROM for inspection if necessary. 
If everything has been fitted correctly, contact Watford Electronics 
for further assistance. 
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BBC MICROCOMPUTER MODEL B PLUS 

Remove the four large fixing screws holding the lid of your BBC 
Plus down. Two of these are located in the base of the machine, and 
two are at the rear. Locate the ROM sockets at the rear left of the 
machine. The ROM sockets are the two rows of three sockets running 
across the back of the machine, and numbered ICs62, 68, 35, 44, 57 
and 71. Socket IC71 already contains a ROM (the Basic and Operating 
System ROM) and should not be touched. Any of the other sockets may 
be used for the Apollo ROM. 

Once a free socket has been found for the Apollo ROM, take the 
ROM from its protective foam or tube, and check that the legs are at 
the correct angle. If they are not, then you should bend them 
appropriately by placing the ROM on its side on a flat surface, and, 
by applying firm and even pressure, bend the legs where they are at 
their thickest (closest to the ROM body) until they match with the 
socket into which the ROM is to be inserted. 

You should now insert the ROM into its socket. Note that the 
small notch at one end MUST face the rear of the machine (All the 
other chips on your BBC Plus will also face in this direction). YOU 
will damage the ROM if it faces the wrong way when the power is 
turned on. Line the pins up with the socket, and apply gentle 
pressure until the ROM fits into its socket. Check that all the legs 
have fitted correctly, and that none are bent out from the socket. 
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CHECKING THE ROM WORKS 


Once the ROM has been inserted into your machine you need to test 
it. Whether you screw the lid back to your BBC Plus before or after 
testing is entirely up to you, but it should ideally be replaced 
before prolonged use. When you are ready, connect your BBC Plus back 
to the power, video display and any other peripherals that you may 
have, and turn on the power. To check that the Apollo ROM is fitted 
correctly and working, enter the following: 

♦HELP 

If the Apollo ROM is installed correctly, the following will be 
printed on the screen (possibly along with some text from any other 
ROMs present): 

Apollo ROM 1.03 

If this message, or a similar one, does not appear, then recheck 
the fitting operation. If everything has been fitted correctly, 
contact Watford Electronics for further assistance. 
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BBC MASTER SERIES 128 

Locate and remove the four fixing screws, marked FIX, on the 
underneath of the Master. Locate the three ROM sockets to the right 
of the machine, near the small loudspeaker. The Apollo ROM should be 
fitted in either the second socket from front of the machine or an 
external board, if you have one. Alternatively, the ROM can be fitted 
to one of the EPROM cartridge units that are available. 

Once a socket has been located, take the ROM from its protective 
foam or tube, and check that the legs are at the correct angle. If 
they are not, then you should bend them appropriately by placing the 
ROM on its side on a flat surface, and, by applying firm and even 
pressure, bend the legs where they are at their thickest (closest to 
the ROM body) until they match with the socket into which the ROM is 
to be inserted. 

You should now insert the ROM into its socket. Note that the 
small notch at one end MUST face the left hand side of the machine 
(All the other chips on your BBC will also face this direction). YOU 
will damage the ROM if it faces the wrong way when the power is 
turned on. Line the pins up with the socket, and apply gentle 
pressure until the ROM fits into its socket. Check that all the legs 
have fitted correctly, and that none are bent out from the socket. 
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CHECKING THE ROM WORKS 

Once the ROM has been inserted into your machine you need to test 
it. Whether you screw the lid back to your BBC Master before or after 
testing is entirely up to you, but it should ideally be fixed back 
into its old position before prolonged use. When you are ready, 
connect the Master back to the power, video display and any other 
peripherals that you may have, and turn on the power. To check that 
the Apollo ROM is fitted correctly and working, enter the following: 

♦HELP 

If the Apollo ROM is installed correctly, the following will be 
printed on the screen (possibly along with some text from the other 
ROMs present): 

Apollo ROM 1.03 

If this message, or a similar one, does not appear, then recheck 
the fitting operation. If everything has been fitted correctly, 
contact Watford Electronics for further assistance. 
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MODEM CONNECTION 

Connecting the Apollo modem is really very simple. Locate the 
modem somewhere convenient, with respects to the computer, telephone 
line and somewhere where control dial may readily be accessed. 

Rotate the selector dial on the front of the modem to the "TEST" 
position. The mains plug should be wired up in the nocmal fashion 
(see the information sheet with the modem) and connected to the 
mains. Connect the cable marked "LINE" to a standard BT type 600 
telephone jack socket. If you do not have a suitable socket, then 
contact BT and ask them to install one for you. You may find it 
convenient to purchase a dual gang connector and to plug an existing 
telephone into the other outlet of the splitter. 

The data cable is the last item to be connected. Examine one end 
of the cable, and locate the gap in the outer metal ring. Insert this 
cable into the modem with the gap facing upwards. Insert the other 
end of the cable into the serial port of your BBC micro, also with 
the gap in the metal ring facing upwards. 

The modem may be tested by turning the front selector to TEST and 
then entering: 

♦BAUD 3 

♦ON 

♦CHAT 

If you then press some keys on the keyboard, you should see them 
echoed on the screen. The TD and RD lights should flicker. Exit chat 
mode with Shift-Escape. 
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LOGGING ONTO PRESTEL 


For most modem owners, the most frequently accessed commercial 
database is British Telecom's Prestel Viewdata network, and its most 
popular "information provider" Micronet 800. To help you get started 
using the Apollo Modem, there now follows a quick example of how to 
log onto Prestel. 

To log onto Prestel, use one of the following commands 

For those users lucky enough to have 618 as their local Prestel 
number (London and SOME other areas), simply type... 

♦PRETZEL 

or its abbreviation (note that spelling is correct - there is another 
command *PRESTEL, as we shall see)... 

*P. 

For users with a special local number, use... 

♦BAUD 1 (sets baud rate to 1200/75) 

♦PRESTEL <your Prestel number goes here> 


When you receive the Prestel logon page, type in your 10 number 
account code, followed by your personal 4 character password. For 
users without a Prestel account, use 4444444444 as the account and 
4444 as the password, and you will be let into a demonstration 
account. 

If you don't know your local Prestel telephone number, dial the 
operator and ask for "Freefone Prestel" and they should be able to 
help. For more information on Prestel mode, see the ♦PRESTEL command 
section. 
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ACCESSING PUBLIC BULLETIN BOARDS 

Along with the recent boom in modem telecommunications, there has 
emerged a large number of free access bulletin boards scattered all 
over the country (and even the world...!) covering a wide range of 
specialist subjects. These are mainly single user systems running on 
microcomputers such as the BBC, Apple II and the Tandy TRS-80. 

Since they are privately run, they are not all available 24 hours 
a day, so always check the "opening hours" before calling up a board, 
and remember that the operators don't HAVE to run the systems, so 
give them some respect. 

You will find many interesting and varied subjects discussed on 
bulletin boards, as well as public domain (free) downloadable 
software, online games, and a whole host of other attractions. 
Sometimes it is even possible for you to have an online chat with the 
System Operators (or "Sysops" as they like to be known). 

Bulletin boards are usually available at two main transmission 
speeds: 1200/75 (BAUD 1), and 300/300 (BAUD 4). Some boards may have 
a baud scan option where the host modem will try to lock on to your 
transmission speed. 

To log on to a bulletin board, use the following commands 

♦BAUD 1 (or ♦BAUD 4) 

♦TERMINAL <telephone number of the bulletin board> 

Remember that as most boards are run on a single telephone line, 
many of them may be engaged during peak hours. A list of other 
bulletin board numbers is usually available on most boards, as well 
as on Prestel, and in many computer magazines. For detailed 
information on using the features of the terminal mode, see the 
♦TERMINAL command. 
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APOLLO COMMUNICATIONS ROM - COMMAND SECTION 


The following section describes each of the Apollo ROM's * 
commands in detail. Each page is titled with the command syntax, 
along with the parameters the command requires to function. 

If the parameters of a command are optional, then they will be 
written in brackets. Some commands have multiple parameters, and 
these parameters may have more than one choice. If this is the case, 
each choice will be separated by a | character. 

Words in upper case mean that the actual word needs to be typed 
in (such as ON); words in lower case provide a general description of 
the word required, e.g. <filename>. Example programs are listed where 
applicable, along with references to associated commands. 

If a command requires an ON or OFF parameter, and no parameter is 
entered, the Apollo ROM assumes the OFF state, e.g. 

♦ANSWER OFF 

could be typed as... 

♦ANSWER 
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♦ANSWER <ON|OFF> 

One of the major features of the Apollo ROM is its ability to 
automatically answer any incoming telephone call. This feature is 
obviously vital if you intend to operate a Bulletin Board service of 
your own that can be left running without human intervention every 
time the telephone rings. 

Before auto answer mode can be used, the modem has to be set to 
the baud rate that you wish to operate with (1200 or 300). This is 
set by adjusting the selector dial on the front of the modem to 1200 
ans or 300 ans and by issuing a *BAUD command (see later). Once the 
modem is ready to answer incoming calls, you must enable the ROM to 
handle the call and then the incoming data. This is achieved by using 
the command 

♦ANSWER ON 

This tells the ROM to set up a background task (a system interrupt) 
to detect an incoming call and generate an error when it does so. The 
error number is 60 and the error message is "Rrrring!". Although an 
error is generated, it does not mean that something has gone wrong; 
it is simply a convenient way of interrupting Basic. 

So, a short program to answer the telephone and jump into 
terminal mode could be as follows (note that many of the example 
listings included here have had additional comments added; these 
should be removed before you attempt to run the program) 

10 *BAUD 2 - sets baud rate. Don't forget the modem as well. 

20 ON ERROR GOTO 50 

30 ^ANSWER ON - sets answer mode 

40 REPEAT UNTIL FALSE - wait indefinitely 

50 IF ERR <> 60 THEN REPORT:PRINT "at line";ERL:END 

60 ♦ON - puts modem online 

70 ♦TERMINAL 

80 END 

So far, so good, but what happens when the caller goes offline? 
Your program would be stuck in terminal mode and nobody else would be 
able to call up, because your modem would still be online (line 60). 
The answer is really quite simple. When ♦ANSWER has answered the 
call, it then proceeds to wait until the user goes offline, when it 
generates another error; the error number of this error is 18 and the 
message is "Line disconnected". 
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When a call is answered, the ROM automatically places the 
contents of function key 10 into the keyboard buffer, so it's a good 
idea to define key 10 with something along the lines of *KEY 10 
"0LD|MRUN|M", so that if the call is dropped, or Break is pressed, 
the program will automatically re-initialise itself. 

The following program will answer the call and jump into HOST 
mode. You can substitute the *H0ST command with a call into your own 
bulletin board software if you want. If the Break key is pressed, or 
the caller ends the call, the program will again re-initialise 
itself. 

The ^ANSWER setting is held over a soft break. Remember to set 
your modem to the correct speed first:- 

10 *KEY10"0LD|MRUN|M" 

20 *0FF - puts the modem offline 
30 *BAUD 2 - sets baud rate. 

40 ON ERROR GOTO 80 
50 ^ANSWER ON 

60 PRINT "Waiting for caller..." 

70 REPEAT UNTIL FALSE 

80 IF ERR = 18 THEN RUN - if line disconnected, then restart 

90 IF ERR <> 60 THEN REPORT:PRINT "at line ";ERL:END - report other 

errors 

100 *0N - go on line 

110 *H0ST ON - enters remote host mode 

120 END 

The modem will usually answer the line before the telephone has a 
chance to start ringing. For more detailed information about the 
commands used in the above programs, refer to the relevant sections 
in this User Guide. You are advised not to leave auto answer mode 
active when you are expecting incoming ’vocal’ calls. 


PAGE 15 




The Apollo Modem 

♦BAUD <!|2l3|4l5l6|7|8> 


This command selects the receive and transmits speeds at which 
the Apollo ROM is to operate. The Apollo modem itself has a dial 
which also has to be set accordingly (if the two of these are not set 
to the same baud rate, then data cannot be transmitted correctly). 


The Apollo ROM has four settings that are applicable to the 
Apollo modem; these are: 


Baud rate 
1 


2 


3 


4 


Speed Description 

1200/75 orig The Apollo ROM defaults to this baud 
rate after a hard break. It is the 
speed used to log on to Prestel, and is 
the fastest receive speed supported by 
the modem. 


75/1200 ans This is known as 'Reverse Prestel' as 

it is the speed at which the Prestel 
host operates. You would use this if 
you were operating your own Viewdata or 
bulletin board service, or if you were 
uploading files to another user. 

300/300 ans This is the speed used if you wish to 

provide a 300 baud host, or for more 
reliable file transfer on a noisy line. 


300/300 orig This is the speed used when calling 300 
baud services such as bulletin boards, 
and for file transfer. 


The Apollo ROM also supports 4 other full-duplex speeds, although 
the Apollo modem does not. These are:- 


5 1200/1200 6 2400/2400 
7 4800/4800 8 9600/9600 

These could be used when two BBC micros are linked together via the 
serial port with a cable, for rapid file transfer, or for direct 
communications to a mainframe, with the Apollo software acting as a 
terminal. 
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♦BREAK 


The ♦BREAK command is an extremely useful inclusion in the Apollo 
ROM's instruction set. It is used to send a 'break' signal along the 
telephone line. This is a signal recognised by most host systems as a 
'panic button' which makes the host computer immediately abort any 
operation and return to its command level. 

The break signal can be typed in as a * command, or simply sent 
by pressing the f9 function key whilst in TERMINAL mode. 

The command actually sends a continuous stream of high bits to 
the host for approximately one second. On PSS, sending a line break 
more than twice in quick succession is likely to result in the user 
being returned to PAD level. Note: Do not confuse the *BREAK command 
with the Break key (pressing the Break key will terminate your 
call!). 
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♦CARRIER 


The 'carrier’ is a continuous tone sent by the host computer (and 
your computer, but on a different frequency) that tells your computer 
that the host is still 'listening' to you. If there is no carrier 
present, then you cannot communicate with the system. 

This command simply waits for up to 20 seconds, listening for 2 
seconds of continuous carrier tone. If, after 20 seconds, no carrier 
is found, the "No Carrier" error is generated (error code 67). 

The ^CARRIER command can be exitted at any time by pressing 
Escape. As soon as 2 seconds of carrier have been detected the 
♦CARRIER command will exit. For example, consider the short program 
below that automatically logs onto Prestel, with redial facilities. 


10 *BAUD 1 

20 ON ERROR GOTO 80 

30 PRINT "Logon process commencing.. 

40 *DIAL <your Prestel telephone number> 

50 ♦CARRIER 
60 ♦PRESTEL 
70 END 
80 ♦OFF 

90 IF ERR <> 67 THEN CLS:REPORT:PRINT " at line ";ERL:END 
100 T%=TIME 

110 REPEAT UNTIL TIME - T% > 250 - pause before redial 
120 GOTO 40 


This command is useful to include within your own programs to see if 
a *DIAL command has succeeded in making contact with another computer 
or not. 
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♦CHAT 


One of the three terminals resident in the Apollo ROM is *CHAT. 
♦CHAT is the simplest of these three, and is a scrolling terminal. It 
echoes all characters transmitted and received, including control 
codes. It has no built-in options for printout, or disk spool, and is 
only really used under two circumstances. 

The first is when talking to certain bulletin boards run on BBC 
computers which have the option of displaying colour in MODE 7 
(teletext mode). Because *CHAT doesn't filter out any characters, 
teletext colour control codes (which ^TERMINAL would filter out) can 
be displayed correctly. The Prestel terminal is unsuitable for colour 
Bulletin Boards because it is not designed to scroll the screen. 

However, since *CHAT allows all codes through, some line noise or 
mistransmitted characters could easily cause havoc. For example, if a 
control code 22 was sent (a mode change) followed by another value, 
e.g. the code for a "0" character (ASCII 48), the screen mode would 
change to MODE 0! If colour codes aren't required, always use 
♦TERMINAL instead. 

The second, and most useful function of *CHAT, is to mirror all 
characters from ♦HOST mode (see *H0ST, later in this chapter, for 
more information). In *CHAT mode, all keys will produce their ASCII 
values, but the cursor keys can still be used for copying over text. 
To exit from *CHAT, press Shift and Escape. 
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♦CIjOSK 


This command will close any open disk files. This command is 
extremely useful since attempts to access an open file (e.g. to write 
to it, lock, or delete it) would generate an error otherwise. Some of 
the Apollo commands perform such actions on files. 

For this reason, a *CLOSE command should be put at the beginning 
of any programs using the Apollo ROM that access files. If, while 
running, an error causes the program to jump out of a file handling 
routine, then the files should be *CLOSEd too. 

The Acorn DFS 1.20 (DNFS) ROM and later Watford DFSs leave files 
open over a Break, but the early Acorn DFS 0.90 does not. *CL0SE is a 
direct equivalent of CL0SE#0. Note that this command is equivalent to 
*TIDY in the Watford DFSs. 
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♦DIAL <number> 


This is the command that actually instructs the modem to dial the 
telephone number that you require. It will dial a number of any 
length, so all direct international numbers can be dialled. 

The *DIAL command ignores all characters except the numbers 0 to 
9 and the - (minus) character, which sends a short pause down the 
line. A pause such as this can be useful when you wish to select an 
outside line from an internal exchange system (such as one where you 
have to dial 9 first). 

For example: 

♦DIAL 9-618 

Where the 9 selects an outside line, and 618 dials the London Prestel 
number, or: 

♦DIAL 0101-212-123-4567 

for an international call to New York. 

Because all characters other than the minus sign and 0 to 9 are 
ignored (including spaces), you can insert the name of the 
establishment that you are dialling in the actual telephone number, 
or any other relevent comments. For example: 

♦DIAL 618L0ND0N PRESTEL 

or 

♦DIAL 6PRE1STEL8 
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♦DLOAD <filename> 


♦DLOAD is one of the file transmission commands of the Apollo ROM 
and is used to download a file from either another user, a bulletin 
board or from some other online system. When you enter the *DLOAD 
command, followed by a filename, a menu will be printed as follows: 

Download a file: 

1. Normal ASCII text 

2. Expanded ASCII-HEX data 

3. XMODEM binary data (CPM) 

Select appropriate file protocol -> 

You should now press the number corresponding to the protocol 
required by the host computer (most bulletin boards ask for XMODEM). 
The Apollo ROM will then proceed to download the file and save it to 
disk under the name specified. When the download is complete, the 
computer will bleep and the message 

Done! 

will be displayed. When downloading from a bulletin board in terminal 
mode, you would normally opt for XMODEM and, when the board sends the 
message 

File open, awaiting initial NAX 

press fO (function key 0) and type DLOAD followed by a filename (the 
* itself dis not required when entering * commands in this way). 

When ASCII files are being downloaded, the text will not be 
printed on the screen, but sent straight to disk. As both HEX and 
CPM/XMODEM data is being downloaded the Apollo ROM will display 
information about the current block. All the CPM errors (bad block, 
checksum, etc.) will be displayed if necessary. 

If you do not specify a filename, an error will be generated and 
the download aborted. Do not confuse *DL0AD with Prestel's CET 
telesoftware downloading format. For more information about file 
transfer, see the commands ^ET, ^SEND, *UL0AD and the section 
entitled "User to User". 
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♦FLOW <ON|OFF> 


When you are reading text being transmitted from an online 
system, it is highly likely that you will need to pause from time to 
time so that the text doesn't scroll off the screen while you are 
reading it. The obvious way to freeze printing on the BBC micro is to 
hold down Shift and Control on the keyboard, as you normally do when 
reading through Basic listings, etc. However, the trouble with this 
is that the host computer doesn't know that you have stopped 
accepting and printing data, and so continues to send data down the 
line, even although it obviously cannot be displayed. 

This will be alright for a few seconds as the BBC has a small 
internal input buffer, but after a few seconds that buffer becomes 
full and you will start to lose all new text being transmitted 
because there is nowhere to save it and it cannot be printed. 

Fortunately,, this loss of data can be prevented using a protocol 
known as XON/XOFF "handshaking". This protocol controls the flow of 
data being received by sending control codes from the user to the 
host computer. In effect, when your computer cannot receive any more 
data, the host computer is asked to stop sending data. When more data 
can be accepted, the host is asked to start sending again. 

When *FLOW is set to ON, the Apollo ROM will be ready to handle 
the XON/XOFF flow control protocol. It is suggested that *FLOW is 
always set to ON when talking to most commercial systems and bulletin 
boards. Note the flow control of this sort is entirely software, and 
is not implemented within the Apollo modem itself. 

When you wish to stop the host system sending data, simply press 
CTRL-S and any system with XON/XOFF handshaking implemented will 
pause. When you wish to resume, simply press CTRL-Q and the host 
computer will start transmitting data again. If the host computer 
does not respond to these control codes, then ensure that a ♦FLOW OFF 
command is issued, otherwise data may be lost. 

Another feature of the Apollo ROM designed to help provide 
reliable service is what happens when the XON/XOFF protocol is not 
known and the screen display is paused. Most terminal software for 
the BBC, under these circumstances, would not accept any more data 
from the host computer. The problem with this is that, seeing that no 
data is being taken, some host systems will decide that the call is 
finished with and terminate the call. To prevent this, the Apollo 
ROM will keep receiving data and discarding it. This means that 
although this data is lost, the host computer will not disconnect the 
call thinking that the user has hung up. 
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Pressing f8 whilst in terminal mode will toggle the flow control 
on and off. Flow control is set to OFF after a reset, and 
automatically set to ON when *TERMINAL is entered. The state of *FLOW 
is held over a soft break. 
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*GET<ASCIHEX|CPM> <filename> 


*GET is a software downloading command, derived from the *DLOAD 
command, which is of great value to people transferring data files 
user-to-user. 

This is not actually a single command, but a group of three. Each 
command specifies the file transmission protocol in the actual 

command name (unlike *DL0AD, which presents the user with a menu) 
which means that a whole string of *GET commands can be strung 

together, even in a Basic program, and left to run without user 
intervention. The command syntaxes are as follows:- 

*GETASC <filename> - Download an ASCII file 
*GETHEX <filename> - Download a HEX-ASCII file 
*GETCPM <filename> - Download an XMODEM/CPM file 

If no filename is given, an error will be generated and the 
downloading operation aborted. Typing anything other than ASC, HEX or 
CPM after a *GET will result in a 'Bad command' error message. Note 
that there should be no space between the GET and the protocol type. 

For more detailed information on file transfer, refer to the "User to 

User" chapter of this User Guide. 
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♦HOPPIT 


This command simply disables the Apollo ROM completely, and makes 
the BBC micro think that the ROM doesn't exist at all. After 
executing a *HOPPIT command, it is best to press CTRL-BREAK to reset 
the computer's internal pointers. 

Due to the way in which Acorn decided to allocate memory to 
applications programs on the BBC micro, the Apollo ROM has to use 
some 'underhand' techniques to preserve various flags (such as 
whether *FLOW is active). Unfortunately, there can occur situations 
where another piece of software in your machine will also perform 
such tricks. If this is the case, then a software clash may occur. By 
using the *HOPPIT command, you should be able to get round most (if 
not all) ROM and program clashes concerning the Apollo ROM. 

To resurrect the ROM, either switch the computer off and on 
again, or type the following command: 

*FX 200,3 

and press CTRL-Break. This action will clear the computer's memory, 
so make sure you save any RAM-resident programs to disk before using 
it. If a total disablement of the ROM is not required, then refer to 
the *N0VEC command detailed later. 
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♦HOST <ON|OFF> 


The 'remote host system' included in the Apollo ROM is regarded 
by many as its most novel and powerful feature. In simple terms, the 
host facility enables a remote caller to take over (virtually) 
complete control of the host computer that they have called, rather 
like having a keyboard extension that can span many hundreds or 
thousands of miles. Note that the host computer, in this context, 
refers to the machine running the Apollo ROM software (elsewhere in 
this manual, host generally refers to the computer at the other end 
of the telephone line). 

This concept opens up some fantastic possibilities: For example, 
leaving your BBC Microcomputer running a small program to auto answer 
the line, and call *HOST mode, you could go to work and, using any 
standard computer with a modem attached (such as an IBM PC), you 
could dial home and use your BBC as if you were typing on it at home! 

You could therefore edit View files remotely, or even write 
programs in BBC Basic, etc. In fact, any software that follows a few 
simple guidelines will work correctly in host mode. These general 
rules are: 

i. Software must not directly access the screen (peeking and 
poking, using the ? operator from Basic, or equivalent). This rules 
out commercial videogames, and ROMs such as Wordwise, which do not 
follow the 'official' programming guidelines issued by Acorn. View 
does adhere to these rules and will work correctly. 

ii. The effects of various ♦FX commands cannot be transmitted; 
for example, there is no easy way to transmit the effects of a *FX 
call to alter the auto repeat rate, or the flashing colours delay 
time. Such commands will work correctly on the host machine, but not 
on the caller's machine, even if it's another BBC micro. 

iii. Accessing the serial port workspace, or any other areas of 
memory used by the Apollo ROM are bound to cause problems. 

iv. If the remote user is not using a BBC micro then they will 
not be able to make use of features such as colour, mode changes, 
plot codes etc. 
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When accessing *HOST the remote caller can use any standard 
terminal software, but if they are using another BBC, with an Apollo 
ROM, they should select *CHAT. Since this terminal does not filter 
out any control codes, features such as changing colours and palette, 
changing modes, plotting graphics in high resolution modes, etc will 
all work. 

Because the caller to a host system has total control over your 
BBC microcomputer (unless you are running a user program which 
doesn't allow access to Basic, or the operating system calls) the 
Apollo ROM has some special built in protection mechanisms to prevent 
the caller from misusing the host system. If the caller attempts to 
unlock disk files using the DFS's *ACCESS command (so that they can 
be deleted), or tries to *DIAL or *ANSWER, they will be greeted with 
the error warning: 

No you don't! 

♦ 

So, all locked disk files are relatively safe from erasure. *HOST 
will also stay active over a soft Break. The host system can be 
extremely useful if two programmers wish to debug the same program 
from different sites. 

Due to the power and flexibility of the *HOST command, it is 
difficult to describe it fully in print. It is best to experiment 
with the host mode, and develop your own applications for it. 
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♦MSG <ON|OFF> 


This command is used to switch on and off the messages produced 
by the Apollo ROM. When ON, (the default), all messages will be 
printed as usual. When OFF, no text will be printed on the screen by 
the ROM. 

This feature is very useful for programmers when writing 
communications software, for example a bulletin board package, since 
they can disable all messages and prompts printed by the ROM, and 
print their own instead. 

Note that when *DIAL is used, the numbers will still be printed, 
although the message 'Dialling...' will not. An auto-dial routine 
could therefore execute a *MSG OFF, and then print an alternative 
message, as follows 

10 *MSG OFF 

20 PRINT "Calling London Prestel now: 

30 *DIAL 618 
40 ♦CARRIER 
50 ♦MSG ON 
60 ♦PRESTEL 
70 END 


PAGE 29 




The Apollo Modem 

*NOVEG 


The Apollo ROM makes quite extensive use of the BBC micro 
operating system's vectored "interrupt" routines (for more 
information about these, consult the Advanced User Guide, or a book 
on machine code). However, these interrupt routines may clash with 
other pieces of software running in the BBC micro. 

For this reason, the *NOVEC (NO VECtors) command has been 
implemented. *NOVEC disables all interrupt dependent routines in the 
Apollo ROM without disabling the whole ROM (as *HOPPIT does). This 
means that commands such as *TERMINAL, *STATUS, etc. will work to a 
large extent with no interrupt routines. Features such as handshaking 
(*FLOW) and *TIME01IT will, however, not function. The effect of a 
*NOVEC command can be cancelled by pressing the Break key. 
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♦OFF 


This command switches the Apollo ROM (and the modem) offline. It 
is extremely important that you issue a *OFF command (or press Break) 
when you have finished communicating with a system. This is because, 
until you disconnect, you will be incurring telephone charges and 
possibly online time charges from the system you are connected to. 
Also, if you are connected to a single user system, you are 
preventing others from accessing it. 

Commands such as *CARRIER issue a *OFF command automatically if 
no carrier is found. Remember to include a *OFF in your bulletin 
board or other communications software after a ♦TIMEOUT "Time limit 
exceeded" error has been generated (see later for details of 
♦TIMEOUT). 

After a *OFF command has been issued, always wait for three 
seconds or so for the telephone line to settle before putting the 
modem online again (in an auto-redial program, for example). 


PAGE 31 




The Apollo Modem 

*0N 


This command switches the Apollo ROM and modem online. It is 
basically the equivalent of picking up the telephone receiver to 
'grab* the line. You do not need to use *0N if you are simply going 
to *DIAL a number and then enter one of the terminal modes, since 
they perform the equivalent of a *0N command automatically. 

There are two main uses of *0N. 

i. Firstly, in your own communications or bulletin board type 
software, you may wish to expressly put the modem on line. 

ii. Secondly, when you are talking directly to another user, with 
your VOICE (!), and you decide that you wish to go online to, say, 
transfer some data files. You will need *0N to go online. If you are 
the person who made the call, then do the *0N before you put down the 
telephone handset, otherwise you will drop the line. 

Always remember to go offline using *OFF or pressing Break, when 
you have finished your call. 


PAGE 32 




The Apollo Modem 

♦PRESTEL (<telephone number>) 


This command invokes the Apollo ROM's comprehensive Viewdata 
terminal. If the *PRESTEL command is postfixed by a telephone number, 
the Apollo ROM will dial the number, wait for a carrier tone, and 
then enter the Viewdata terminal. 


A useful feature of the Prestel terminal is the automatic logon 
facility. By defining function key 11 with your personal account 
number (and optionally your 4 character password and any page number 
you wish to jump to directly after logging on) you can let the ROM 
carry out the whole log-on process. For example: 

*KEY 11 "12345678PSWD" 


would log on using the above account number and 4 character password, 
whereas 


♦KEY 11 "12345678PSWD*81052|M" 


would log on using the above account number and password, and then 
jump to page 81052 automatically. Note the |M to complete the entry 
of the page number. 

Note that no spaces are included, as you must define key 11 with 
the exact key sequence you would normally use to log on. Also note 
that you do not actually have to PRESS function key 11 at all; the 
ROM merely uses the user defined key workspace to store the data. You 
should use a *BAUD command to set the correct baud rate if necessary. 

Once the Prestel terminal has been entered, you can then browse 
through the database as usual, either by pressing a numeric key to 
select a page route, or by jumping directly to a specific page. The 
following non-numeric keys have special uses in the Prestel terminal: 

(asterisk) 

This key is used to jump directly to a specific Prestel page, for 
example, *930# to see if any new mailboxes have been sent to your 
account. Do not confuse this with the BBC's operating system * 
commands (which can be issued by using function key fO). 


PAGE 33 





The Apollo Modem 


RETURN 


This key actually sends a # to the host system (Prestel was 
developed in the days when numeric keypads were the 'norm'). It is 
pressed at the end of an input, e.g. *800 <Return>. Whenever Prestel 
asks you to press a #, always press the Return key. 

£ (pound) 

This key sends an underline code (ASCII code 95) to Prestel. 

£ (hash) 

This key sends a pound sign to Prestel. 

The reason why some of these keys produce strange codes is that 
the ASCII and Prestel standards differ slightly. 

COPY 


This key tells Prestel to re-display the current frame (it 
actually sends the codes *00# to Prestel). This is very useful if a 
frame has been corrupted by line noise during its transmission or if 
a * command has been issued with fO, and you wish to re-examine to 
the screen. 

CURSOR LEFT 

This key tells Prestel to jump back to the previous frame. 
Prestel remembers the last three frames displayed. After the third 
frame, Prestel will simply re-display the third frame. The same 
effect can be achieved by pressing * followed by Return (the 
equivalent of *#). 
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MAILBOX EDITING 


One of the most popular facilities provided on Prestel is the 
ability to send electronic messages (Mailboxes) to other users and 
information providers on the system. Mailboxes are sent on special 
pages called ’response frames'. Some of these are available for user 
to user mailboxing, while the rest are used for such things as reply 
services to advertisers and information requests. 

The most frequently used mailbox frames are found on pages 77, 88 
and 89, although a directory of literally hundreds of frames can be 
found on page 7. To send a mailbox, simply call up one of these 
frames (e.g. *77#), and when Prestel has finished transmitting the 
frame, type in the recipients mailbox number (sometimes known as a 
systel) and press Return. If the number is correct, then the 
recipient's name will be displayed. 

You are now ready to enter your message. You may type in upper 
and lower case, and move about the frame using the four cursor keys. 
Spelling mistakes can be corrected using the Delete key. The Delete 
key actually sends three codes to Prestel; cursor left, a space, and 
another cursor left. This is because there is no true delete option 
available with the Prestel system and hence it has to be simulated. 

The Underline key (next to the cursor up key) enables you to move 
the cursor directly to the beginning of the message by sending an 
ASCII code thirteen. 

The Apollo ROM's Prestel terminal also allows you to send 
attribute codes to the host computer. This means that you can create 
messages that include features such as colour, flashing text, double 
height text, or the teletext mosaic graphics. These features are 
achieved by pressing the Escape key, followed by an attribute value, 
e.g. Escape A to produce red text. A full list of these attributes is 
included in APPENDIX A at the end of this User Guide. Note that the 
TED (Teletext Editor) ROM, also marketed by Watford Electronics, 
contains a very powerful teletext editor which may be used to create 
mailboxes. 

When you have finished entering your message, press Return. 
Prestel will ask you to press "1" to send the message, or "2" to 
abort. If you wish to re-edit the frame in any way, press Copy and 
re-enter the recipients systel. Pressing Return will clear all text 
after the cursor, so remember to move to the end of the message 
before pressing Return. 
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PRESTEL FUNCTION KEYS 


The red function keys have been assigned special meanings in 
Prestel mode. They cannot be pressed while the host system is 
transmitting a frame, otherwise the computer would not be able to 
display the frame correctly. Normal function key definitions can be 
accessed by pressing Shift in conjunction with the desired function 
key. 

fO Operating system *. command 

This key allows you to directly issue operating system commands. 
Pressing fO will display a white asterisk on the bottom line of the 
screen. Note that you should not exit the terminal using a command 
such as *BASIC, as it does not allow the ROM to 'clean up' properly. 
Do not confuse star commands with the green asterisk used to jump to 
a new Prestel frame. Use Shift-Escape to exit the Prestel terminal 
correctly (see later). 

f1 This key has no effect in Prestel mode, 
f2 Save frame using frame number as filename. 

This key will save the current screen to disk using the frame 
letter (a to z) as the directory, and the first seven characters of 
the frame number as the filename. 

For example, to save the Micronet news headlines frame, simply 
call up the frame (*8001110#), and press f2. The frame will be saved 
to the current drive under the filename "a.8001110". This is 
extremely useful when you wish to save a long news story consisting 
of a number of consecutive frames. 

Do not use this option to save mailbox frames, or any other frame 
that is displayed without a frame number. Note that subdirectories 
will need creating if this feature is to be used with ADFS. 
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f3 Save frame user chosen filename 

This option is similar to the one above, except that the filename 
used is entered by the user, and not generated from the current page 
number. This should always be used to save received mailboxes. The 
filename is subject to the normal file specification syntax of the 
DFS. 


To re-display a frame, simply *LOAD it directly to the screen 
memory, or *TYPE it. 

fA This key has no effect in Prestel mode. 
f5 Download a telesoftware file. 


This key allows you to download a Prestel 'telesoftware' program. 
Telesoftware is a computer program or series of programs that are 
stored on the Prestel database in a special format (known as the CET 
standard). By means of a special routine in the Apollo ROM (the 
downloader), you are able to receive these programs and store them 
directly in the BBC's memory. Telesoftware for the BBC micro is 
available from various Information Providers in the Prestel 
Microcomputing closed user group, the most prominent ones being 
Micronet 800 and Viewfax 258. Some of these programs carry a 
downloading charge (you will be warned if this is the case), but many 
are totally free. 

To download a program, follow the exact procedure outlined in the 
frames leading up to the file itself. When Prestel tells you to begin 
downloading, simply press function key f5. 

If any errors are found whilst downloading a frame (due to line 
noise, say), them the Apollo ROM will tell Prestel to retransmit the 
frame. When downloading is complete, the ROM will ask you for a 
filename under which to save the program. The filename should follow 
the usual DFS file specification. 

f6 Reveal frame 

Some sections of Prestel (e.g. quizzes and competitions) display 
questions on the screen, with answers 'hidden' from view using a 
special Viewdata code called 'conceal'. If the screen ever says 
"Press reveal for answer", simply press f6, and all will be revealed! 
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f7 Send frame text to printer 

This option allows the user to print the textual contents of a 
frame on a parallel printer. It will make no attempt to print 
Prestel's graphics; instead it will filter out these codes whenever 
it can, to prevent spurious side effects. 

If you usually require a *FX6 command to enable printer 
linefeeds, send this code using fO. 

f8 and f9 These keys have no effect in Prestel mode. 

To exit the Prestel terminal, press Shift and Escape together. 
This will return to Basic, or your previous language ROM, but will 
also keep the modem online. To re-enter the terminal, type *PRESTEL 
again and press Copy to re-display the current frame. Once you are 
finished, exit as above and enter *OFF. You could also press Break as 
an alternative, if you wished. 


*1 

*90 

*930 

*931 

*92 

*7 


*456 

*800 

*8001110 

*800110 

*800951 

*258 

*2582000 

*258216 


USEFUL PRESTEL PAGES 

Prestel front page 
Log off Prestel 
Check for new mailboxes 
View your mailbox store 
Check your current bill 
Mailbox index 

Prestel Microcomputing front page 
Micronet front page 
Micronet news headlines 
Micronet features index 
Micromouse 

Viewfax front page 
Viewfax news headlines 
'Tubelink' user group 


*810 ClubSpot front page 

*81052 Multi-User Arena 

*123 Prestel Focus 
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♦PRETZEL 


This is a special command which will automatically dial up 
Prestel, wait for a carrier tone, and then enter the Prestel 
terminal. The number dialled is 618, which is all that is needed to 
dial Prestel in London, and many other main cities in the UK. 

The command actually performs the following 


♦BAUD 1 
♦DIAL 618 
♦CARRIER 
♦PRESTEL 


1200/75 mode 
London Prestel 
Wait for carrier 
Enter Prestel terminal 


♦PRETZEL can be abbreviated to *P., assuming the Apollo ROM has 
the highest priority in your BBC. Refer to the section on the 
♦PRESTEL command for more details. 
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*PSS 


Like *PRETZEL, *PSS dials and logs onto a specific service - in 
this case, the Slough node (computer) of British Telecom’s Packet 
Switch Stream network. PSS is a system which allows a user to link up 
to a host system anywhere in the world (as long as it is linked to a 
packet switching network) for the cost of a local call, plus online 
time charges, and hence offers a lot of potential for very little 
expenditure. 

Many hundreds of computer systems all over the world are 
accessible via PSS, ranging from public access databases (Prestel and 
Telecom Gold in the UK, The Source, CompuServe, Protocol and 
People-link in the USA), multi-user games (MUD, AMP, etc), university 
and polytechnic computers, to government and research centres and 
many large multinationals. 

The system is called Packet Switch Stream, because data is split 
into small ’packets' which are sent to their destination via the most 
efficient route, depending upon other network traffic. 

What *PSS does is dial up the 1200/75 Slough node of PSS (a local 
call for Londoners), and then waits for a carrier, enters ^TERMINAL, 
and sends a special logon sequence (called a PSS profile), which is 

D1 <Return>. 

Note that you will need a PSS account, and the logon address and 
account for the system you wish to make contact with. Contact British 
Telecom National Networks for more information on PSS. 
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♦SKND<ASCIHEX|CPM> <fllcname> 


The *SEND group of commands follows the same syntax as *GET (see 
earlier), and Is used to transmit files user to user in a similar way 
to *ULOAD, except that the transmission protocol is specified in the 
command name, for example: 

♦SENDASC HELLO 

will transmit an ASCII text file called "HELL/)", at the currently set 
baud rates. There should be no space between the *SEND and the 
protocol type. 

The obvious advantage of specifying the transmission protocol in 
the command name is that a Basic program can be written with a number 
of *SEND (and *GET) commands and then left to run without any user 
intervention. 

If no filename is specified, an error will be generated and the 
uploading operation will be aborted. For detailed information on file 
transfer between two users, refer to the 'User to User' section of 
this manual, and also the *UL0AD command. 
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♦STATUS 


This command displays various pieces of information about the 
current state of the Apollo ROM. The screen format upon a 'hard 
break' is as follows: 

Apollo Modem status info 


Answer detection 
Auto flow control 
Auto baud detection 
Modem state 
Baud rate 


Off 

Off 

Off 

Offline 
1200 Originate 


All these values are retained across a normal Break, 
state. For further information on the various 
♦STATUS, refer to the following command sections: 


except the modem 
values listed in 


♦ANSWER, ♦FLOW, ♦ON, +OFF, *BAUD. 
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♦TERMINAL (<telephone number>) 


This command invokes the main terminal section of the Apollo ROM, 
and is used when accessing bulletin boards, mainframes, and any other 
'scrolling* system that does not require graphics and colour codes, 
or Viewdata format. 

♦TERMINAL alone will enter the terminal directly. However, if you 
append a telephone number to the command, the ROM will *DIAL the 
number, perform a *CARRIER and then enter the terminal unless a 
carrier is not detected, in which case a "No carrier" error will be 
generated, e.g: 

♦TERMINAL 01 648 0018 

When you enter the terminal, the current screen mode, foreground 
and background colours are preserved, but the screen and any text 
windows are cleared. The terminal is suitable for any screen mode. 
The terminal filters out all ASCII codes above 127,and below 32, 
except 7 to 13. If you require these filtered codes, use *CHAT 
instead as it does not perform such filtering. 

Automatic password entry can be achieved with the ^TERMINAL 
command in the same way as the Prestel terminal i.e. by defining 
function key 11 with the logon string. You will need to use |M to 
send a carriage return, e.g: 

♦KEY 11 "L0GIN|M1234,1234|MHELL0|M" 

When in terminal mode, the normal function key definitions can be 
accessed by pressing Shift together with the desired key. The cursor 
keys produce the corresponding control codes for their direction of 
movement (left = 8, right = 9, down = 10, up = 11). The cursor keys 
can be used with the copy key to edit on-screen text by executing the 
operating system call: 

*FX 4,0 
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TERMINAL FUNCTION KEYS 

The function keys have special uses in terminal mode. These are as 
follows: 

fO Operating System _* command 

Pressing this key displays a * prompt on the top line of the 
screen, and allows you to directly enter an operating system command. 
You should not exit the terminal via *BASIC, as this will not allow 
the Apollo ROM to 'clean up' afterwards (use Shift-Escape). 

f 1 Exec ja disk file 

This option is of great value if you frequently send text files 
to an electronic mail system. Rather than typing them in whilst 
online, you can edit them offline using a text editor or word 
processor, and then transmit them to the host computer using this 
option. Text must be prepared and stored on disk in standard ASCII 
format before the ^TERMINAL mode is entered. Wordwise, View and 
InterWord and most other word processors are able to produce suitable 
ASCII text files. 

WORDWISE AND WORDWISE PLUS 


When the document is complete, use the 'Spool ASCII file' option 
(number 8 from the Wordwise menu) and the file created this way will 
be suitable for transmission. 

VIEW 

View cannot directly produce ASCII text files in the same way 
that Wordwise can, but the following procedure can be used to achieve 
the same results: 

1. Enter View's command mode. 

2. Type *SPOOL "<new filename>" 

3. Type SCREEN "<filename of your VIEW file>" 

4. When the spooling has finished, type *SPOOL 

5. Load in the new file (possibly with NEW and READ <filename>), 
re-edit it to remove words such as *SPOOL from the text, and re-save 
it. 

The file is now ready for transmission. 
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♦BUILD 


You may also use the DFS command *BUILD to create an ASCII file. 
Simply type 

♦BUILD "<filename>" 

and then enter the text you wish to send. Note that this method does 
not give very flexible editing facilities. When you have finished 
entering your text, press Escape. 

When your text file is ready for transmission, and you are at the 
position on the host system where you would normally begin typing the 
message, simply press fl and enter the filename after the EXEC: 
prompt. The rest is done for you. 

f2 Spool text to disk 

This option allows you to direct all text displayed on the screen 
to a disk file, rather like 'printing' to disk. Situations when this 
is useful included the spooling of messages, instructions, etc for 
later reading. 

When you press f2, you will be prompted with SPOOL: to which you 
should reply with a suitable filename. When you wish to stop the 
spool operation, just press f2 again and the file will be closed. You 
may read the text file later by using the *TYPE command, or by 
loading it into a word processor. 

f3 Split-screen toggle 

This option enables or disables the split screen option of the 
terminal. When disabled, the terminal displays all characters 
normally, in the manner of most other terminals. When enabled, the 
terminal will split the screen into two sections - one large window 
operates as usual, while the bottom four lines of the screen are 
dedicated to displaying input from the user as it is entered; which 
is not necessarily when it is echoed and displayed in the top window. 

The main advantage of this is that user input and text sent from 
the host will not be mixed, even if you are typing ahead of the host 
computer's display speed. If the host computer is configured to echo 
characters received, they will be displayed in both windows. 
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If any control codes are typed on the keyboard, they will be 
displayed in the input window as a character, followed by the 
corresponding letter; for example Control-C is displayed as A C. 
Carriage returns ( A M) are displayed normally, though. 

The default setting of the split screen is OFF. 

f4 to f8 ON/OFF TorrIcs 

These keys all produce an ON/OFF toggle action. For ease of use, 
the key produces a low pitched bleep when set ON, and a high pitched 
bleep when set OFF. 

f4 Incoming CR/LF toggle 

This key toggles the action of the Apollo ROM when an incoming 
carriage return is received. When set OFF, only a carriage return is 
actually printed. When set to ON, however, a carriage return causes 
both a carriage return and a line feed to be printed. 

If characters sent from the host computer are repeatedly printed 
on the same line, you will need to set this option ON, and it there 
is a blank line between each line of text, then set it to OFF. 

The default setting for f4 is OFF. 

f5 Outgoing CR/LF toggle 

This key is similar to f4, except that it toggles the action of 
the Return key when you send an outgoing carriage return. If set ON, 
a linefeed will be set along with the carriage return. If set OFF, a 
carriage return will be sent by itself. This can be useful in user to 
user communications. 

The default setting for f5 is OFF. 

f6 Local Echo toggle 

Most host computer systems re-transmit each character received 
back to the caller so that, by seeing them displayed, the caller 
knows that the characters are being received correctly. If the host 
computer does not echo back characters, then you will be unable to 
see what you are typing (unless you have the split screen option on). 
For this reason, a local echo option has been included. 
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With this option set ON, the Apollo ROM will print each character 
as it is entered, at the current cursor position. With this option 
OFF, the Apollo ROM sends each character entered to the host 
computer, and displays all characters sent from the host computer. If 
you have local echo set ON, and the host is also echoing characters, 
you will see everything that you type displayed twice. 

The default setting of f6 is OFF. 

f7 Printer output 

This option switches the printer output ON and OFF. When set ON, 
all text received will be sent to the parallel printer port. If you 
usually need to issue a *FX 6 command to set the line feeds correctly 
on your printer, then you will still have to do this using fO. Do not 
confuse the functions of f4 and f5 with the *FX 6 command. 

The default setting of f7 is OFF. 
f8 XON/XOFF Handshaking control 

This key switches the XON/XOFF handshaking routine ON and OFF, 
and is directly equivalent to the *FLOW command. For further details, 
refer to the *FLOW section of this User Guide. 

The default setting of f8 is ON. 

f9 Line break signal 

This key will send a line break to the host computer and is 
directly equivalent to issuing a *BREAK command. For further details, 
refer to the *BREAK section of this User Guide. 


To exit the terminal, press Shift and Escape together. This is 
the only 'legal' way to exit terminal mode, as it closes all open 
files and 'tidies' the currently set functions. Remember that after 
you issue a Shift-Escape, you will still be online until you issue a 
*OFF, or press Break. Do not issue commands such as *BASIC to exit 
the terminal. 
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♦TIMEOUT <minutes> 


Since bulletin boards are almost exclusively run on a single 
computer system with a single telephone line, logging on to a popular 
board would be extremely difficult (even at 5 in the morning!) if 
each user was allowed unlimited time on a call. For this reason, most 
bulletin boards have a set time limit for its users - if they don't 
log out within the time limit, the board automatically logs them off, 
thus allowing somebody else to log in. 

♦TIMEOUT is one of the commands that makes writing custom 
bulletin board software much simpler when using the Apollo ROM, and 
helps implement the above time limit constraints with ease. 

The *TIMEOUT command has to be given a parameter with a value 
between 0 and 255, representing the number of minutes the user is to 
be allowed. Once set, the ROM keeps track of the time left. When 
there is one minute left on the call, the ROM prints up a "One minute 
left" message. 

When the timeout reaches zero, the ROM generates an error "Time 
limit exceeded" (error number 64). If a value of 0 is initially 
provided, then the timeout feature is disabled. 

This command does not actually log the user off - this is left to the 
software, e.g: 

10 ON ERROR GOTO 60 

20 *TIME0UT 10 - set call to 10 mins. 

30 ♦BAUD 2 - 75/1200 baud rate 
40 ♦ON 

50 PROCboard - bulletin board routines 
60 IF ERR <> 64 THEN REPORT:PRINT " at line ";ERL:END 
70 ♦OFF - Log user off 
80 RUN - Re-run program 

The above listing is not a complete program, but just shows the 
overall structure that you would use. 
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♦ULOAD <filename> 


*ULOAD is a command used for uploading (transmitting) data files 
to another user or to a database system/bulletin board. It is the 
complement of the *DLOAD command and is presented in an identical 
manner. 

When you type *ULOAD followed by a filename, you will be 
presented with a menu as follows: 

*ULOAD "ERIALC" 

Upload a file 

1. Normal ASCII text 

2. Expanded ASCII-HEX data 

3. XMODEM binary data (CPM) 

Select appropriate file protocol -> 

You should press the number corresponding to the protocol required 
and the Apollo ROM will search for the file on the disk and begin to 
transmit it block by block. When transmission is complete, the 
computer will emit a short bleep. 

If you do not specify a filename, an error will be generated and 
the upload operation will be aborted. For more information refer to 
the commands *GET, *SEND, *DLOAD and the "User to User" section. 
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APOLLO ROM COMMAND SUMMARY 


Command 

Parameters 

Abbrv. 

Description 

♦ANSWER 

<ON OFF> 

♦A. 

Allows ROM to answer a call 

♦BAUD 

<l-8> 

♦BAUD 

Sets rx/tx speeds of ROM 

♦BREAK 


♦BR. 

Sends a line break to the host 

♦CARRIER 


♦CAR. 

Waits for host carrier tone 

♦CHAT 


*CH. 

Enters simple terminal 

♦CLOSE 


♦CL. 

Closes all open disk files 

♦DIAL 

<number> 

♦DIAL 

Dials telephone number 

♦DLOAD 

<fsp> 

*DL. 

Downloads a file 

♦FLOW 

<ON OFF> 

*FL. 

Toggles XON/XOFF handshaking. 

♦GETASC 

<fsp> 

♦GETA. 

Downloads ASCII file 

♦GETHEX 

<fsp> 

♦GETH. 

Downloads expanded ASCII-HEX file 

♦GETCPM 

<fsp> 

♦GETC. 

Downloads XMODEM file 

♦HOPPIT 


♦HOP. 

Disables the Apollo ROM 

♦HOST 

<ON OFF> 

♦HO. 

Enters remote host mode 

♦MSG 

<ON OFF> 

♦MS. 

Turns off all ROM output messages 

♦NOVEC 


*N. 

Disables all ROM interrupt routines 

♦OFF 


♦ 0 . 

Switches modem offline 

♦ON 


♦ON 

Switches modem online 

♦PRESTEL 

(<number>) *PRES. 

Enters Prestel terminal 

♦PRETZEL 


♦P. 

Dials 618 & enters Prestel terminal 

♦PSS 


♦PS. 

Dials 1200/75 PSS & enters terminal 

♦SENDASC 

<fsp> 

♦SENDA. 

Uploads ASCII file 

♦SENDHEX 

<fsp> 

♦SENDH. 

Uploads expanded ASCII-HEX file 

♦SENDCPM 

<fsp> 

♦SENDC. 

Uploads XMODEM file 

♦STATUS 


♦ST. 

Displays Apollo ROM status info 

♦TERMINAL 

(<number>) *TE. 

Enters the scrolling terminal 

♦TIMEOUT 

<0-255> 

*TI. 

Auto-disconnect for bbs software 

♦ULOAD 

<fsp> 

*U. 

Uploads a file 


The abbreviations listed above may be incorrect if a ROM with a 
higher priority in the computer intercepts the command first. All 
commands may be proceed by a ’Z' prefix, e.g: 

♦ZSTATUS 
♦ZANSWER ON 
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APOLLO ROM ERROR MESSAGES 


The Apollo ROM makes extensive use of error messages to pass 
information back to the user, alleviating the need for the user's 
program to continually scan various status flags. In order for a 
Basic program to respond correctly to these errors, it is essential 
that the correct error numbers are known and used. Listed below are 
all the error messages that can be produced by the Apollo ROM, along 
with their respective numbers and a brief description as to what the 
errors mean. 

Terminated 17 

When Shift and Escape are pressed together, to exit *CHAT, 
*PRESTEL or *TERMINAL, the 'Terminated' error is generated. The 
error number is the same as that normally produced by pressing 
Escape, and can be trapped in the same way as Escape is normally 
trapped (you could issue an INKEY-1 to check the Shift key if you 
really need to distinguish the two). 

Line disconnected 18 

This error is generated when a caller to your computer ends a 
call, or is cut off. It will only be detected if *ANSWER is set ON. 
For more information, see *ANSWER. 

Rring! 60 

When ^ANSWER is set ON, the Apollo ROM waits for an incoming 
call and then generates this error when the ring is detected. For 
more information, see the ^ANSWER command section earlier. It is by 
trapping this error that you know that an incoming call has arrived. 

Can't access file! 63 

When you request the Apollo ROM to transmit a file, using *UL0AD 
or *SEND, the ROM will look for the file on disk. If the file cannot 
be found, then this err Dr is generated. 

Time limit exceeded 64 

When the ^TIMEOUT counter has reached zero, this error is 
generated. For more information, see the *TIME0UT command section. 
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Filename? 65 

This error is generated if no filename is specified in the file 
transfer command line, such as *DLOAD, *ULOAD, *SEND and *GET. 

No you don *t! 66 

This error is generated when a remote user in *HOST mode tries 
to execute various commands which shouldn't be used in this mode, 
notably *DIAL and ^ANSWER. 

The other command trapped by *HOST is ^ACCESS. this means that a 
remote user couldn't delete any of your locked files, because he 
would be unable to unlock them. For more information, see *HOST in 
the command section. 

No carrier 67 

The ^CARRIER command will check for the presence of two seconds 
of continuous carrier being transmitted by the host computer. If 
after 20 seconds no carrier is found, this error will be generated. 
For more information, refer to ^CARRIER. 

Illegal! 

This is not actually an error message, and so cannot be trapped. 
It is simply a message displayed when the *BAUD command is attempted 
with a value out of the range 1 to 8. 
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USER TO USER COFtflJNICATIONS 


THE PROTOCOL 

One of the most useful (and most used) facilities of a modem is 
the ability to transfer programs and data from one user to another. 
This process is known as User to User file transmission, and permits 
data files to be sent between individuals over very large distances 
in a very short time. 

With the Apollo modem, the file(s) to be transferred need to be 
stored on disk, and in a suitable form (it's no use sending someone 
a tokenised BBC Basic program if they need to convert it for use on 
an IBM PC!). 

Two other matters that need arranging before the data can be 
transmitted are that both users select the correct baud rates and 
the appropriate file transfer protocol. The Apollo ROM supports 
three protocols, and these are describe below: 

1. Normal ASCII text 

This protocol simply takes each byte of data and sends it 
unaltered to the other user, without any error checking or 
additional information whatsoever. It is useful for the quick 
transmission of such things as text files, but is unsuitable for the 
transmission of programs, and important data (since there is no 
error checking, the only way of ensuring the object file is correct 
is by reading through it). 

2. Expanded ASCII-HEX data 

This protocol takes bytes of data and translates them into two 
hexadecimal digits, e.g. a character 127 (the code for delete) is 
not sent as a single byte 127, but as two bytes, the ASCII codes for 
7 and F (127 is &7F in hexadecimal). 

ASCII-HEX is useful when transferring files to computers such as 
the Tandy series which are fussy about which characters they allow 
through their serial ports. ASCII-HEX is exceptionally useful for 
transmitting programs to people using Email systems such as Telecom 
Gold, since the protocol transmits the complete file, along with the 
file addresses (useful for machine code programs). The data has some 
error detection, and informs the user if any errors are found, but 
does not re-transmit the corrupt data. 
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3. XMODEM Binary data 

This protocol is the most popular file transmission method 
amongst the modem fraternity, since it is a world standard as far as 
the protocol is concerned. It is known as XMODEM, CPM, and sometimes 
the "Ward Christiansen" protocol (named after the person who devised 
it). 

XMODEM provides proper error checking of all data, along with 
re-transmission of corrupt blocks of data. Because of this, it is 
the most reliable of the three file transfer protocols implemented 
in the Apollo ROM. 

XMODEM files are sent in 128 byte blocks of data; if an error is 
detected then the whole block is re-transmitted and the user is 
informed of the error. Some of the errors you may come across are 

"Checksum", "Bad Block", and "Oops!". 

The XMODEM protocol has been extended in the Apollo ROM to allow 
the transmission of file addresses for BBC micro files. If both 
users are using the Apollo ROM, the ROM will detect this and 
automatically send the file information to the other Apollo ROM at 
the end of the transmission. If the other user is not using the 
Apollo ROM, you will have to give them the file information 
verbally. 

The User to User process 

The various commands associated with file transmission are 
mentioned in the Command section of this user guide. For downloading 
and uploading of single files to and from bulletin boards and other 
host systems, *DLOAD and *ULOAD are ideal, since they present the 
user with a comprehensive menu. For user to user file transfer, 
*SEND and *GET are the most suitable, since a group of files can be 
transmitted by writing a small Basic program containing consecutive 
commands. Note that the file transfer commands only corrupt a very 
small amount of memory (see later for further details) and will not 
interfere with normal Basic programs. 
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For example, If you wonted to send three files to a friend, you 
would dial him/her up and wnit for them to ready their computer and 
modem, etc. You would then use a simple program as follows: 

10 CLS:*CAT - Look at the disk files 
20 *BAUD 2 - You wnnt to send at 1200 baud 

30 *0N - Go online 

40 ^CARRIER - check/wait for carrier tone 
50 *SENDCPM GARY 
60 *SENDCPM JEZ 
70 *SENDCPM F00 

80 REPEAT UNTIL GET =32 - wait for the SPACE BAR to be pressed 

90 *0FF 
100 END 

The recipient would require a program as follows: 

10 *BAUD 1 - Receive at 1200 

20 *0N - go online 

30 ^CARRIER - check for carrier tone 

40 *GETCPM GARY 

50 *GETCPM JEZ 

60 *GETCPM F00 

70 REPEAT UNTIL GET = 32 - Wait for SPACE BAR to be pressed 

80 *0FF - go offline 
90 END 

When you were ready to send the files, you would run this 
program and put down the telephone (remember that whoever makes the 
telephone call is the only one who can break the call, so they must 
go online before they put the receiver down!). 

When the files have been sent, you would pick up the telephone 
and then press the Space Bar to turn the modem offline. You could 
then continue talking normally, perhaps to discuss what the various 
files are. 

Note that the person sending the files uses *BAUD 2, since that 
means transmitting at 1200 baud, and receiving at 75 (the other 
user's ROM sends 'acknowledged' or 're-transmit please' codes back 
to you after each block), and the person receiving the files uses 
*BAUD 1. 

If, when using XMODEM, you repeatedly get errors (if a number of 
blocks have to be transmitted two or three times each, etc), it is 
best to abort the file transmission and re-dial in the hope of 
obtaining a clearer line. 
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NOTE: The Apollo ROM uses a small 128 byte buffer at &C80 during 
file transfer. This memory is usually reserved for the storage of 
user-defined characters, but the authors decided that rather than 
pushing PAGE up by &100, it would be better to ’borrow' memory from 
elsewhere. 


DATA PROTOCOLS 


Various online computer systems around the world are configured 
to special data protocols to determine the number of bits 
transmitted for each byte of data - how many stop bits are used, and 
whether parity (a form of error checking) is implemented or not. 

Most systems nowadays have done away with parity checking (the 
official Prestel specification includes even parity, but even this 
has been ignored!), and tend to run using 8 bits, no parity, and 2 
stop bits. 

However, some systems may still require these settings, and 
there is a way of implementing them using the BBC Computer, using 
OSBYTE or *FX call 156 (&9C). Here are the 8 settings you may come 


across: 

Bits 

Parity 

Stop 

FX Command 

7 

Even 

2 

*FX 156,0,227 

7 

Odd 

2 

*FX 156,4,227 

7 

Even 

1 

*FX 156,8,227 

7 

Odd 

1 

*FX156,12,227 

8 

None 

2 

*FX 156,16,227 

8 

None 

1 

*FX 156,20,227 

8 

Even 

1 

*FX 156,24,227 

8 

Odd 

1 

*FX 156,28,227 


8 bits, no parity, and 2 stop bits is the most common setting, 
and also the default one. 
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USING THE APOLLO ROM WITH CASSETTE 


Despite the fact that we are now in a time of cheap disk drives, 
and even cheaper disks, some people will still want to use that 
antiquated storage medium known as cassette tape. The Apollo ROM is 
designed to operate with a disk system, but many of its commands will 
function correctly on a tape based system. 

The main drawback to using tape with a modem is that the BBC 
micro cannot transmit data along the serial port and the cassette 
port simultaneously, and attempting to do so will simply cut off the 
serial port connection, and thus terminate any telephone call in 
progress. This means that commands concerning the uploading and 
downloading of software will not be of any use to a cassette user as 
the modem will go offline after the first block or so is received. 

Prestel downloading is possible, however, since these programs 
are downloaded to main RAM, and then saved from memory, although once 
the program has been saved you will need to re-dial Prestel. 
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USING THE APOLLO ROM WITH A SECOND PROCESSOR 


The Apollo ROM has been designed to be compatible with all Acorn 
second processors. However, to make the ROM correctly active over the 
tube, a small procedure has to be adhered to: 

1. Disable the ROM using *HOPPIT. 

2. Switch on the second processor. 

3. Type *FX 200,3 

4. Press CONTROL-BREAK. 

Now use your second processor as normal. 
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APPENDIX A: PRESTEL ATTRIBUTE CODES 


These codes are used to produce colour, flashing, double height 
and mosaic graphics effects on mailbox or other response frames on 
Prestel. 

Attribute codes are produced by pressing Escape followed by an 
alphanumeric key as listed in the table below. Each code takes up two 
character cells of the frame, so a large number of codes will reduce 
the maximum length of a frame. 


ESC A 

Alpha RED 

ESC Q 

Graphic RED 

ESC B 

Alpha GREEN 

ESC R 

Graphic GREEN 

ESC C 

Alpha YELLOW 

ESC S 

Graphic YELLOW 

ESC D 

Alpha BLUE 

ESC T 

Graphic BLUE 

ESC E 

Alpha MAGENTA 

ESC U 

Graphic MAGENTA 

ESC F 

Alpha CYAN 

ESC V 

Graphic CYAN 

ESC G 

Alpha WHITE 

ESC W 

Graphic WHITE 

ESC H 

Flashing 

ESC X 

Conceal display 

ESC I 

Steady 

ESC Y 

Contiguous graphics 

ESC L 

Normal height 

ESC Z 

separated graphics 

ESC M 

Double height 

ESC \ 

Black background 



ESC ] 

New background 



ESC } 

Hold graphics 



ESC 

Release graphics 


Note that the characters printed in this manual represent those that 
appear on the keyboard itself; some of these characters look 
different when viewed in mode 7. Do not worry about this. 
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APPENDIX B - ONLINE INFORMATION SERVICES 


Bibliographical Retrieval Service 
BRS After Dark 
1200 Route 7 
Latham 

New York NY12110 
United States 

Tel: 0101-518-783-1161 

A 'keyword retrieval' system for medical and scientific information, 
but has now an 'After Dark' service for home users that includes 
bulletin boards, teleshopping and entertainment services. This is one 
of the cheaper systems which costs $6 or $15 per hour. 


CompuServe International Services Inc. 

5000 Arlington Ctr. Boulevard 
Columbus, Ohio 
OH 43220 
United States 

Tel: 0101-614-457-8600 

CompuServe (CIS) is a large American database consisting of over 40 
DEC-10 minicomputers, and over 50 million K of information stored 
online. Its most popular section seems to be the online real-time CB 
Radio simulator which allows multi-user conversations to take place 
via the keyboard. 


Dialog Incorporated 
P.0. Box 8 
Abingdon 
Oxon 0X13 6EG 

Tel: 0865-730969 

Dialog is a database system set up by the Lockheed Corporation. It is 
one of the 'bibliographical' databases, i.e. you enter a keyword and 
the system will search for the information that you require. Dialog 
can cost anything up to $200 per hour, but for that you can access 
over 90 million records! 
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Dow Jones News Retrieval 
P.0. Box 300 
Princeton 

New Jersey NJ 08540 
United States 

Tel: 0101-609-452-2000 

The DJ Network is mainly a service for accessing American stories, 
and will cost between $9 and $60 per hour depending upon the time of 
day and the type of information required. 


EasyLink Limited 

114 Great Suffolk Street 

London SE1 0SG 

Tel: 01-928-9001 

EasyLink is an electronic telex service that enables micro owners to 
send and receive national and international telexes. Incoming telexes 
are stored in a 'mailbox' on the system, ready for you to read when 
you next log on. 


Homelink 

Nottingham Building Society 
5-13 Upper Parliament Square 
Nottingham NG1 2BX 

Tel: 0602-419393 

Homelink is a home banking service that is available on the Prestel 
database to members of the Nottingham Building Society. You can look 
at the service by calling up page 444 on Prestel. 


Micronet 800 
8 Herbal Hill 
Clerkenwell Road 
London EC1R 5EJ 

Tel: 01-278-3143 

Micronet are the main microcomputing section on Prestel. If you join 
Prestel, be sure to join Micronet/Prestel Microcomputing too! 
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MUSE Ltd 
6 Albermarle Way 
London EC1 

Tel: 01-603-1173 

Muse run the commercial version of Essex University’s famous 
Multi-User Dungeon (MUD) adventure game, in conjunction with British 
Telecom New Information Services. MUD is probably the best reason for 
buying a modem! 

For a demo game, set your modem to 1200/75 and dial 01-998-8899 and 
use the account MUDGUEST and the password PROSPECT. 


One-To-One 
Scorpio House 
102 Sydney Street 
London SW3 6NL 

Tel: 01-351-2468 

One-To-One is a popular Electronic Mail and Telex service aimed at 
home and business users. 


People-Link 

Arlington Ridge Office centre 
3215 N. Frontage Road 
Suite 1505 

Arlington Heights IL 60004 
United States 

Tel: 0101-312-870-5200 

People-link is a relatively new multi-user entertainment system that 
is aimed at people rather than businesses. Its features include a 
'CB' simulator, and other entertainment orientated services. 
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PSS Customer Services Dept. 

G07 Lutyens House 
1-6 Finsbury Circus 
London EC2H 7LY 

Tel: 01-920-0661 

PSS is British Telecom’s Packet Switch Stream service. For more 
information, see the *PSS command. 


The Source 

1616 Anderson Road 

McLean 

Virginia VA22102 
United States 

Tel: 0101-703-821-6666 

The Source is probably America's most popular database, with business 
and entertainment provision. Features include news, reviews, 
electronic mail, user-to-user chatting, interactive debating, and 
special interest groups. There is usually a demo account available 
for you to try out. If you contact The Source they will probably make 
this available to you for a short while. 
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